Xbasic

A5_TOOLBAR_OPEN Function

Syntax

Toolbar_Name as C = a5_toolbar_open(C toolbarname [,L flagGlobal ])

Arguments

Toolbarname

The name of the toolbar that you attempted to open.

toolbarname

The name of the toolbar to open.

flagGlobal

Logical. Optional. Default = .F. .T. = Global toolbar .F. = Local toolbar When Global_Flag is .F., Alpha Anywhere will automatically do the following:

Hide the toolbar when the window from which the toolbar was launched looses focus
Show the toolbar when the window from which the toolbar was launched regains focus
Close the toolbar when the window from which the toolbar was launched is closed.

Description

The A5_TOOLBAR_OPEN() function opens and displays the named toolbar.

If flagGlobal is .f., and if the toolbar is opened from a button or event in an MDI window (e.g. a form), the toolbar will be hidden when the window looses focus and closed when sthe window is closed. You must use Toolbar_Name to close the toolbar with UI_MODELESS_DLG_CLOSE()when you are finished with it.

If you are converting an existing V7 application to V8, you will have to change any calls to A5_TOOLBAR_OPEN() so that they pass in .T. as the value for the Global_Flag variable.

Example

? a5_toolbar_open("Reports")
= "Reports1"
if ui_modeless_dlg_exist("Reports1") then

ui_modeless_dlg_close("Reports1")
end if

Limitations

Desktop applications only.

See Also